Carbon


PixPatChanged

Header: QDOffscreen.h Carbon status: Supported

Notifies QuickDraw that the content of a PixPat structure, including its PixMap structure or the image in its patData field, has been modified.

void PixPatChanged (
    PixPatHandle ppat
);
Parameter descriptions
ppat

A handle to the changed pixel pattern.

DISCUSSION

The PixPatChanged function sets the patXValid field of the PixPat structure specified in the ppat parameter to –1 and notifies QuickDraw of the change.

If your application changes the pmTable field of a pixel pattern’s PixMap structure, it should call PixPatChanged. However, if your application changes the content of the color table referenced by the PixMap structure’s pmTable field, it should call both the PixPatChanged and the CTabChanged functions.

Your application should never need to directly modify a PixPat structure and use the PixPatChanged function; instead, your application should use the QuickDraw functions for manipulating the values in a PixPat structure.

SPECIAL CONSIDERATIONS

The PixPatChanged function may move or purge memory in the application heap; do not call the PixPatChanged function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)